home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / edit / elv18src.zip / doc / versions.ms < prev    next >
Text File  |  1994-01-19  |  20KB  |  468 lines
  1. .Go 14 "VERSIONS"
  2. .PP
  3. \*E currently works under BSD UNIX, AT&T System-V UNIX, SCO XENIX,
  4. Minix, Coherent, MS-DOS, Atari TOS, OS9/68k, VAX/VMS, AmigaDos, and OS/2.
  5. This section of the manual provides special information that applies to each
  6. particular version of \*E.
  7. .PP
  8. For all versions except MS-DOS and VMS,
  9. the file "Makefile.mix" should be copied to "Makefile",
  10. and then edited to select the correct set of options for your system.
  11. There is more information about this embedded in the file itself.
  12. .NH 2
  13. BSD UNIX
  14. .PP
  15. Temporary files are stored in /tmp.
  16. .PP
  17. You should modify /etc/rc so that
  18. the temp files are preserved when the system is rebooted.
  19. Find a line in /etc/rc which reads
  20. .sp
  21. .ti +0.5i
  22. ex4.3preserve /tmp
  23. .LP
  24. or something like that, and append the following line:
  25. .sp
  26. .ti +0.5i
  27. elvprsv /tmp/elv*
  28. .PP
  29. If you do not have permission to modify /etc/rc, don't fret.
  30. The above modification is only needed to allow you to recover your changes
  31. after a system crash.
  32. You can still run \*E without that modification,
  33. and you can still recover your changes when \*E crashes
  34. or when your dialup modem looses the carrier signal, or something like that.
  35. Only a system crash or power failure could hurt you.
  36. .PP
  37. Both \*E and the real Vi
  38. read initialization commands from a file called ".exrc",
  39. but the commands in that file might work on one editor but not the other.
  40. For example, "set keywordprg=man" will work for \*E,
  41. but Vi will complain because it doesn't have a "keywordprg" option.
  42. If the warning messages annoy you, then you can edit the CFLAGS setting
  43. in the Makefile and add -DEXRC=\\".elvisrc\\".
  44. .PP
  45. If you use X windows, you may wish to add "-DCS_LATIN1" to CFLAGS.
  46. This will cause the digraph table and the flipcase option to have default
  47. values that are appropriate for the LATIN-1 character set.
  48. That's the standard character set for X.
  49. .PP
  50. The default mailer used notify users when text is preserver is "mail".
  51. You may wish to change this to "Mail" (with an uppercase 'M').
  52. See the description of "MAILER" in the CFLAGS section of this manual.
  53. .PP
  54. The default keyboard macro time-out value is larger for BSD than it is for
  55. some other systems, because I've had trouble running \*E via rlogin or Xterm.
  56. I guess it takes a while for those keystokes to squirt through the net.
  57. .NH 2
  58. System-V UNIX
  59. .PP
  60. Most SysV UNIX systems use terminfo instead of termcap,
  61. but  the  terminfo  library  doesn't seem to have a standard name.
  62. As shipped, \*E' Makefile.mix  is  configured  with "LIBS=-ltermcap".
  63. You may need to change it to "LIBS=-lterm" or "LIBS=-lterminfo"
  64. or even "LIBS=-lcurses".
  65. .PP
  66. The /etc/rc file (or its equivalent) should be modified as described
  67. for BSD systems, above.
  68. There's a pretty good chance that "make install" will do this for you;
  69. it knows how to create an editor recovery file in the /etc/rc2.d directory,
  70. which is where most modern SysV systems store initialization commands.
  71. You only need to do it manually for older SysV systems.
  72. .PP
  73. The potential trouble with ".exrc" described above for BSD UNIX applies
  74. to System-V UNIX as well.
  75. .PP
  76. The default mailer used notify users when text is preserver is "mail".
  77. You may wish to change this to "mailx".
  78. See the description of "MAILER" in the CFLAGS section of this manual.
  79. .PP
  80. \*E uses control-C as the interrupt key, not Delete.
  81. This was done so that the <Del> key could be used for character deletion.
  82. .NH 2
  83. SCO Xenix
  84. .PP
  85. For Xenix-386, you can use the generic System-V settings.
  86. You may wish to add "-DCS_IBMPC" to CFLAGS, to have the digraph table and
  87. flipcase option start up in a mode that is appropriate for the console.
  88. Also, note that there is a separate group of settings for use with Xenix-286.
  89. It already has "-DCS_IBMPC" in CFLAGS.
  90. .PP
  91. Because Xenix is so similar to System-V, everything I said earlier about
  92. System-V applies to the Xenix version too, except that editor recovery
  93. might belong in a directory called /etc/rc.d/8 instead.
  94. .NH 2
  95. Minix
  96. .PP
  97. There are separate settings in Makefile.mix for Minix-PC and Minix-68k.
  98. The differences between these two are that
  99. the 68k version uses ".o" for the object file extension where
  100. the PC version uses ".s", and
  101. the PC version has some extra flags in CFLAGS to reduce the size of \*E.
  102. The PC version also uses tinytcap (instead of the full termcap)
  103. to make it smaller.
  104. .PP
  105. Minix-PC users should read the CFLAGS section of this manual very carefully.
  106. You have some choices to make...
  107. .PP
  108. The temporary files are stored in /usr/tmp.
  109. The /usr/tmp directory must exist before you run \*E,
  110. and it must be readable & writable by everybody.
  111. We use /usr/tmp instead of /tmp because
  112. after a system crash or power failure,
  113. you can recover the altered version of a file from the temporary file
  114. in /usr/tmp.
  115. If it was stored in /tmp, though, then it would be lost because /tmp is
  116. normally located on the RAM disk.
  117. Also, you'll need a /usr/preserve directory which is readable & writable
  118. by root;
  119. this directory is used to store text files that have been preserved after a
  120. crash.
  121. The "make install" script will create it if necessary.
  122. .PP
  123. \*E uses control-C as the interrupt key, not Delete.
  124. .NH 2
  125. Coherent
  126. .PP
  127. \*E was ported to Coherent by Esa Ahola.
  128. .PP
  129. \*E is too large to run under Coherent unless you eliminate some
  130. features via the CFLAGS setting.
  131. The recommended settings, in Makefile.mix, produce a working version
  132. of \*E which emulates Vi faithfully, but lacks most of the extensions.
  133. You should read the CFLAGS section of this manual carefully.
  134. .PP
  135. You can probably reduce the size of \*E by using tinytcap.c instead of -lterm.
  136. This would allow you to keep most features of \*E,
  137. at the expense of terminal independence.
  138. (Tinytcap.c has ANSI escape sequences hard-coded into it.)
  139. To use tinytcap, just add "tinytcap.o" to the "EXTRA=" line in the Makefile,
  140. and remove "-lterm" from the "LIBS=" line.
  141. .PP
  142. The temporary files are stored in /tmp.
  143. Preserved files are stored in /usr/preserve.
  144. You should modify your /etc/rc file to support file preservation;
  145. add the line ...
  146. .sp
  147.     /usr/bin/elvprsv /tmp/*
  148. .sp
  149.  ... just before the first "/bin/rm" line.
  150. .NH 2
  151. Linux
  152. .PP
  153. The Makefile.mix file has a special section of options for Linux.
  154. There should be no surprises.
  155. Linux is mostly SysV-ish, so the SysV comments above will apply to Linux
  156. as well, except that most Linux systems still have an old-style /etc/rc file.
  157. You should add the command ...
  158. .sp
  159.     /usr/bin/elvprsv /tmp/*
  160. .sp
  161.  ... in there somewhere.
  162. On my SLS 1.02 system, I added it near the end, just before the line that
  163. runs the shell on "/etc/rc.local".
  164. .NH 2
  165. MS-DOS
  166. .PP
  167. \*E was ported to MS-DOS by Guntram Blohm and Martin Patzel.
  168. Willett Kempton added support for the DEC Rainbow.
  169. .PP
  170. Ideally, \*E should be compiled with Microsoft C 5.10 and the standard
  171. Microsoft Make utility,
  172. via the command "make elvis.mak".
  173. This will compile \*E and all related utilities.
  174. .PP
  175. With Microsoft C 6.00, you may have trouble compiling regexp.c.
  176. If so, try compiling it without optimization.
  177. .PP
  178. The "Makefile.mix" file contains a set of suggested settings for compiling
  179. \*E with Turbo-C or Borland C.
  180. (If you have Turbo-C, but not the Make utility,
  181. then you can \fIalmost\fR use the "\*E.prj" file to compile \*E,
  182. but you must explicitly force Turbo-C to compile it with the "medium" memory model.
  183. Most of the related programs [ctags, ref, virec, refont, and wildcard] are
  184. only one file long, so you should have no trouble compiling them.)
  185. The "alias.c" file is meant to be compiled once into an executable named
  186. "ex.exe".
  187. You should then copy "ex.exe" to "vi.exe" and "view.exe".
  188. .PP
  189. \*E stores its temporary files in C:\\tmp.
  190. If this is not satisfactory, then you should edit the CFLAGS line of
  191. your Makefile to change TMPDIR to something else before compiling.
  192. You can also control the name of the temp directory via an environment
  193. variable named TMP or TEMP.
  194. The directory must exist before you can run \*E.
  195. .PP
  196. The TERM environment variable determines how \*E will write to the screen.
  197. It can be set to any one of the following values:
  198. .LD
  199. .ta 1.5i 2.5i
  200.     pcbios    Use BIOS calls on an IBM-PC clone.
  201.     rainbow    Use DEC Rainbow interface.
  202.     ansi    Use ANSI.SYS driver.
  203.     nansi    User faster NANSI.SYS driver.
  204. .DE
  205. .PP
  206.